e.Toscana Compiance 
Request for Comments: 18 
Del: 8/11/2006 
Categoria: Infrastrutturale

	Accordo di Servizio Parte Specifica (ASPS) e.Toscana

Abstract 
======== 
Per instaurare una relazione di servizio tra sistemi  obbligatorio definire in documento un
accordo esplicito sulla erogazione / fruizione delle prestazioni di servizio.
Tale documento  detto Accordo di Servizio (AS). 
Le informazioni contenute nell' AS sono di natura: 
- non formale (quindi rivolte alle persone) 
- formali (quindi rivolte alle applicazioni) 

Laccordo di servizio  composto da una parte comune (ASPC), che formalizza gli
aspetti riusabili in differenti contesti, e da una parte specifica (ASPS), che
precisa e dettaglia la parte comune definendola per una particolare coppia
(erogatore, fruitore). Questa RFC intende definire quali documenti compongono
l'ASPS.
Per dettagli su ASPC si veda l'RFC "Accordo di Servizio Parte Comune e.Toscana" pubblicato sul sito http://web.rete.toscana.it/eCompliance.


Indice 
====== 
1. Introduzione 
2. Convenzioni 
3. Definizioni 
4. Accordo di Servizio Parte Specifica 
4.1 Specifica dei Porti di Accesso 
4.2 Specifica dei Livelli di Servizio
4.3 Specifica delle Caratteristiche di Sicurezza
5. Riferimenti 
6. Note 
7. Autori

1. Introduzione 
=============== 
Una applicazione eroga / fruisce dei servizi utilizzando le intefacce messe a
disposizione dalle Porte di Dominio collacate sui NAL messi a disposizione da
Regione Toscana agli Enti.Sfruttando tale interfacce potr:
- fruire delle prestazioni di servizio erogate da altri soggetti della comunit SPCoop e.Toscana 
- erogare delle prestazioni di servizio agli altri Soggetti della comunit SPCoop e.Toscana 

I Soggetti della comunit SPCoop e.Toscana avranno la possibilit di: 
* reperire informazioni messe a disposizione dalla comunit con estrema naturalezza e con costi minimi 
* arricchire le proprie informazioni con altre reperite dalla comunit con estrema naturalezza e con costi minimi 
* distribuire applicazioni che condividono informazioni 
* minimizzare i costi necessari per adempiere ad un debito informativo verso altri Soggetti 

Prerequisito alla nascita di una comunit di soggetti  la stipula di
accordi chiari tra i partecipanti. L'AS  il contratto che lega il fornitore di
servizio all'erogatore in termini di: 
- specifiche per limplementazione dei sistemi erogatore/fruitore 
- riferimenti per lesecuzione e la gestione dei sistemi erogatore/fruitore 

Una parte di questo contratto  riusabile nell'ambito di pi contraenti. 
Tale parte di accordo di servizio si chiama Parte Comune. 

La parte comune di un accordo di servizio (ASPC) formalizza gli aspetti riusabili
in differenti contesti dell'AS. 
La parte specifica specifica di un AS  precisa e dettaglia la parte comune istanziandola
sulla particolare coppia <erogatore, fruitore> a cui laccordo di servizio si riferisce.
L'obiettivo di questa RFC  chiarire quali documenti compongono l'accordo di servizio parte specifica (ASPS).


2. Convenzioni 
============== 
* AS: Accordo di Servizio 
* ASPC: Accordo di Servizio Parte Comune 
* ASPS: Accordo di Servizio Parte Specifica 
* CART: Cooperazione Applicativa Regionale Toscana 

3. Definizioni 
============== 
* Servizio: 
insieme dei risultati prodotti dai trattamenti effettuati dal sistema Erogatore
e utilizzati dal sistema Fruitore

* comunit SPCoop e.Toscana: 
comunit di Soggetti che espongono e integrano le loro applicazioni per mezzo di
servizi con la finalit di creare uno spazio comune di informazioni alimentato e
fruito dai sistemi informativi dei Soggetti partecipanti 

* Applicazione e.Toscana Compliant: 
applicazione conforme alle specifiche infrastrutturali emanate dal Comitato per
l'e.Toscana Compliant. Il certificato di conformit e.Toscana Compliance 
rilasciato dal Centro Tecnico per l'e.Toscana Compliance.

4. Accordo di Servizio Parte Specifica 
======================================
La parte specifica dellAS contiene la Specifica dei Porti di Accesso, la Specifica dei Livelli di
Servizio e la Specifica delle Caratteristiche di Sicurezza.
 La Specifica dei Porti di Accesso descrive gli aspetti implementativi (livello fisico) dei
Web Service dellerogatore e fruitore, ovvero lURI dei punti daccesso ed i binding
(basati sulla Busta eGov) delle varie operazioni.
 La Specifica dei Livelli di Servizio descrive gli elementi necessari per poter definire i
livelli di servizio, e le obbligazioni che legano la specifica coppia <erogatore, fruitore>
con le azioni correlate. 
 La Specifica delle Caratteristiche di Sicurezza descrive le caratteristiche di sicurezza
supportate e richieste dal servizio. 


4.1 Specifica dei Porti di Accesso 
================================== 
La specifica dell'interfaccia si compone di due documenti :
1) WSDL "fisico" dell'erogatore 
2) WSDL "fisico" del fruitore 

A livello fisico in verranno dettagliati i binding e le URI di accesso di questi due Web
Service. Questo  incluso nella parte specifica in
quanto dipendente dalla particolare coppia <erogatore, fruitore>.

4.1.1 WSDL "fisico" dell'erogatore
==================================
Descrive le operazioni effettivamemente offerte dall'erogatore del servizio.

<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:param="http://www.regione.toscana.it/movimentazione_turistica/erogatore/implementation/param" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://www.regione.toscana.it/movimentazione_turistica/erogatore/implementation" xmlns:types="http://www.regione.toscana.it/movimentazione_turistica/types" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="MovimentazioneTuristica" targetNamespace="http://www.regione.toscana.it/movimentazione_turistica/erogatore/implementation">


	<wsdl:types>	
	  
   	<!-- Importiamo i types definiti nel documento di definizione dei tipi -->	
	  <xsd:schema>
		<xsd:import namespace="http://www.regione.toscana.it/movimentazione_turistica/types" schemaLocation="movimentazione_turistica_types.xsd"/>
	  </xsd:schema>
	</wsdl:types>


	<wsdl:message name="DatiMovimentazioneTuristica">
		<wsdl:part element="types:richiesta_RichiestaRispostaSincrona_InvioDatiStruttura" name="msgRichiesta"/>
	</wsdl:message>

	<wsdl:message name="Ack">
		<wsdl:part element="types:risposta_RichiestaRispostaSincrona_InvioDatiStruttura" name="msgRisposta"/>
	</wsdl:message>

	<wsdl:portType name="MovimentazioneTuristicaPortType">
		<wsdl:operation name="InvioDatiStruttura">
			<wsdl:input message="tns:DatiMovimentazioneTuristica"/>
			<wsdl:output message="tns:Ack"/>
		</wsdl:operation>
	</wsdl:portType>
	
	<wsdl:binding name="MovimentazioneTuristicaSOAPBinding" type="tns:MovimentazioneTuristicaPortType">
		
		<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
		
		<wsdl:operation name="InvioDatiStruttura">
			<wsdl:input>
				<soap:body use="literal"/>
			</wsdl:input>
			<wsdl:output>
			    <soap:body use="literal"/>
			</wsdl:output>
		</wsdl:operation>
	</wsdl:binding>
	
	<wsdl:service name="MovimentazioneTuristica">
		<wsdl:port binding="tns:MovimentazioneTuristicaSOAPBinding" name="MovimentazioneTuristica">
			<soap:address location="http://localhost:8080/MovimentazioneWS/services/MovimentazioneTuristica"/>
		</wsdl:port>
	</wsdl:service>
</wsdl:definitions>

Si noti che il WSDL importa i types definiti nel documento di definizione dei tipi (Types.xsd).

4.1.1 WSDL "fisico" del fruitore
================================
Descrive le operazioni effettivamemente offerte dal fruitore del servizio.

4.2 Specifica dei Livelli di Servizio 
=====================================
Da completare

4.3 Specifica delle Caratteristiche di Sicurezza 
================================================
Da completare

5. Riferimenti 
============== 
Documenti rilasciati dal Centro Nazionale per
lInformatica nella Pubblica Amministrazione (CNIPA): SPC, Sistema pubblico di
cooperazione: Accordo di Servizio, Versione 1.0, CNIPA, 14 Ottobre 2005

6. Note 
=======

7. Autori 
=========
Walter Volpi - walter.volpi@regione.toscana.it
